home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 3 / Gold Medal Software - Volume 3 (Gold Medal) (1994).iso / comms / autodl40.arj / AUTODL.DOC < prev    next >
Text File  |  1994-03-12  |  12KB  |  236 lines
  1. ╔═════════════════════════════════════════════════════════════════════════════╗
  2. ║                                AUTODL v4.00                                 ║
  3. ║              Telix v3.x+ scripts for protocol initiated transfers           ║
  4. ║         AUTODL and the accompanying files are Copyrighted (c)1992-1994      ║
  5. ║                                     by                                      ║
  6. ║                               Joseph M. Tyson                               ║
  7. ║                             All rights reserved                             ║
  8. ╚═════════════════════════════════════════════════════════════════════════════╝
  9.  
  10. PURPOSE:
  11.   To add the capability of auto-starting MPt, DSZ, TXZM, CE-XYZ, SZMODEM,
  12.   ZMODEM (International TeleComm's), GIFLINK, HS/Link and Hydracomm transfers
  13.   to Telix 3.1x without having to configure the protocol yourself.  You just
  14.   tell AUTODL where your protocols are located, and it handles the rest!
  15.   Supports automatic uploads prompting when using internal/external Zmodems,
  16.   HS/Link and Hydracomm.  Also allows for the marking of files to upload with
  17.   a NEW built-in file manager.  Also display the BBS name in the status area
  18.   (REGISTERED VERSION).
  19.  
  20.   The Telix settings for upload/download zmodem crash recovery, port
  21.   configuration, window and disk buffer sizes, locked baud rate and flow-
  22.   control is honored for all the protocols supported by AUTODL. You configure
  23.   the protocols using the "Configure Telix" (Alt-O) panel. Don't worry about
  24.   what settings are needed, its AUTOmatic!
  25. ══════════════════════════════════════════════════════════════════════════════
  26. DISCLAIMER:
  27.   USE AT YOUR OWN RISK! I make no promises to the effectiveness of AUTODL. I
  28.   have every effort to ensure the accuracy and reliability of AUTODL and
  29.   don't anticipate any problems with AUTODL, however I WILL NOT be liable for
  30.   ANY DAMAGE -or- LOSS OF DATA caused by direct -or- indirect use of AUTODL and
  31.   the accompanying scripts. My guarentee is this, "it works for me, it MAY
  32.   work for YOU!".
  33. ══════════════════════════════════════════════════════════════════════════════
  34. REGISTRATION:
  35.   Registration is $10.00 (NC residents add 6% tax). You will receive a postcard
  36.   with your registeration "Key" which unlocks the registered features and
  37.   removes the long SHAREWARE credit screen for this version and all future
  38.   versions of AUTODL.
  39.  
  40.   Send registrations to: Joseph M. Tyson
  41.                          2601 Goshawk Lane
  42.                          Raleigh, NC. 27603-5817
  43.  
  44.   You can contact me at the following:
  45.  
  46.   - The FIDONET & RimeNet TELIX echo (Joseph Tyson).
  47.  
  48.   - FIDO: Joseph Tyson @ 1:3541/1
  49.  
  50.   - Internet: jtyson@cybernetics.net
  51.               Joseph.Tyson@f1.n3641.z1.fidonet.org
  52. ══════════════════════════════════════════════════════════════════════════════
  53. MANIFEST:
  54. @mptul.slc      - Upload script for MPt
  55. @zmdmul.slc     - Upload script for external zmodem
  56. adlcfg.slc      - Configuration script
  57. adlstart.slc    - Starts AUTODL if not running when a download is requested
  58. autodl.doc      - This file
  59. autodl.pkg      - Manifest
  60. autodl.slc      - Main protocol driver
  61. desc.sdi        - Description of contents
  62. file_id.diz     - Description of contents
  63. mailer          - Convenient registeration form
  64. ══════════════════════════════════════════════════════════════════════════════
  65. SETUP:
  66.   Copy the *.slc files in the AUTODL.ZIP file in the directory where
  67.   you keep your other Telix scripts. Make sure the TELIX environment
  68.   variable is set. See the Telix documentation for more information.
  69.  
  70.   Start Telix. Once Telix is running, press <ALT-G>. Type "ADLCFG" and press
  71.   the enter key. Enter the directory where each protocol is kept. The Zmodem
  72.   path requires a fully-qualified path (Drive:\Path\Filename.Ext). This allows
  73.   you to select the zmodem protocol driver you desire. AUTODL automatically
  74.   determines the correct zmodem settings from the supported list of
  75.   zmodem protocols.  If any of the fields are left blank, the protocol will be
  76.   disabled.  Once the fields have been filled in, choose <X> to save the
  77.   configuration file.  The file is stored in the directory pointed to by the
  78.   TELIX environment variable.
  79.  
  80. NOTE:
  81.   There should be NO need to specify any parameters in the options field.
  82.   AUTODL supports the required parameters for the most effective transfer
  83.   possible.
  84.  
  85.   Use the arrow keys to adjust the foreground and background colors of the file
  86.   manager. The border and background colors of the configuration panel change
  87.   to indicate your color selection.
  88.  
  89.   Once the configuration is completed, press "Z" to exit. You may use the
  90.  
  91.   AUTODL.SLC script in the following ways:
  92.  
  93.      - From the terminal session. To do this you first log on to a remote
  94.        system. Once you have done this, type <ALT-G> from the terminal screen.
  95.        You will then be prompted for the script to execute. Type "AutoDL"
  96.        (without the " 's) and press <Enter>. The script will execute until the
  97.        carrrier is lost, at which time it will terminate with an alarm.
  98.  
  99.      - As a "Linked script". While editing the phone entry for your favorite
  100.        system type "AutoDL" in the Linked script field and save the entry.
  101.        The next time you log on this system the AutoDL script will auto-
  102.        matically be executed. The script will execute until the carrrier is
  103.        lost, at which time it will terminate with an alarm.
  104.  
  105.      - From within a logon script. Add this line:
  106.          Call("AutoDL");
  107.        as the last line to you logon script and recompile your logon script.
  108.        the next time you logon the system your logon script will log you on and
  109.        then execute the AutoDL script for you. The script will execute until
  110.        the carrrier is lost, at which time it will terminate with an alarm.
  111. ══════════════════════════════════════════════════════════════════════════════
  112. SETUP OF THE UPLOAD MANAGERS:
  113.   While in Telix, press <ALT-O> to invoke the Telix configuration menu. From
  114.   the menu press <P> for "Protocol options". Choose a free external protocol
  115.   slot from the menu. Press <P><ENTER>. Type "MPT"<ENTER> for the "Protocol
  116.   name". Type "MPTUL"<ENTER> for the "Upload Filename". Type "ADLSTART"
  117.   <ENTER> for the "Download Filename". Press <S> for "BAT or Script". Press
  118.   <N> for "DL Name". The upload manager for MPt is now installed. Repeat the
  119.   process for the external zmodem upload manager "ZMDMUL" using "Ext ZmoDem"
  120.   for the "Protocol name".
  121. ══════════════════════════════════════════════════════════════════════════════
  122. FILE MANAGER:
  123.   The file manager is available for all supported auto upload protocols.
  124.   Merely toggle option "I" in the ALDLCFG configuration panel. The files
  125.   listed are the ones contained in the upload directory specified in the paths
  126.   configuration. The file manager can list a maximum of 115 filenames.
  127. ══════════════════════════════════════════════════════════════════════════════
  128. FILE MANAGER KEYS:
  129.   A     - Mark all files listed.
  130.   C     - Clear all marked files.
  131.   E     - Manual entry of filenames.
  132.   L     - Log (change to) a new directory.
  133.   ESC   - Cancel File manager.
  134.   SPACE - Toggle marked file.
  135.   ENTER - Accept marked files.
  136.   HOME  - Goto first filename listed.
  137.   END   - Goto last filename listed.
  138.   PGUP  - Top of column.
  139.   PGDN  - Bottom of column.
  140. ══════════════════════════════════════════════════════════════════════════════
  141. ENTERING AUTODL KEY:
  142.   Start Telix. Once Telix is running, press <ALT-G>. Type "ADLCFG" and press
  143.   the enter key. At the AUTODL configuration panel press "R". Enter the
  144.   information from the postcard EXACTLY as it appears at the appropriate
  145.   prompts.
  146. ══════════════════════════════════════════════════════════════════════════════
  147.   If you followed the above procedures the AUTODL script system is now
  148.   installed. If you instruct a remote system you are going to do a Zmodem,
  149.   HS/Link or HydraComm upload, you will be prompted to enter the files to send
  150.   automatically.
  151.  
  152.   When you are ready to download and the remote host has Puma and you have MPt,
  153.   go ahead and use Puma. AutoDL knows how to handle it. That's all there is
  154.   to it. This script is sure to enhance your usage of both Telix, DSZ, TXZM,
  155.   SZMODEM, CE-XYZ, ZMODEM, GIFLINK, MPt (Puma), HS/Link, Hydracom. By the way,
  156.   be sure to register these fine products with their respective authors.
  157. ══════════════════════════════════════════════════════════════════════════════
  158. NOTE:
  159.   If you experience problems with your protocols being executed and your using
  160.   Telix v3.2+, turn "Swap out of memory..." (ALT-O G P) OFF. I cannot use
  161.   swapping myself.
  162.  
  163.   If you make ANY changes to you Telix configuration while AUTODL is in use,
  164.   WRITE the changes to disk so AUTODL can pick them up.
  165. ══════════════════════════════════════════════════════════════════════════════
  166. SUGGESTIONS & HELP:
  167.   Please excuse the documentation; I'm a OS/2, Windows programmer by profession
  168.   and well, "I don't do docs!". If anyone would like to help me...
  169.  
  170.   I'm my own beta tester so I'm sure I may have missed something. And as always
  171.   suggestions are appreciated.
  172. ══════════════════════════════════════════════════════════════════════════════
  173. FUTURE PROJECTS:
  174.   I'm interested in ANSI music (not much use for it myself, but a few friends
  175.   asked me to write a script; No promises however, OS/2 v2.1 is gonna keep me
  176.   busy). EMSI script. ???
  177. ══════════════════════════════════════════════════════════════════════════════
  178. TRADEMARKS AND PRODUCTS
  179. ──────────────────────────────────────────────────────────────────────────────
  180.   Telix - Exis Inc.
  181.           P.O. Box 130
  182.           West Hill
  183.           On CANADA M1E 4R4
  184.  
  185.   DSZ/GSZ - Omen Technology Incorporated
  186.             17505-V Northwest Sauvie Island Road
  187.             Portland Oregon 97231
  188.  
  189.   MPt & Puma - MPt Software Company
  190.                Matthew Thomas
  191.                PO Box 4694
  192.                Racine, WI 53404
  193.  
  194.   HS/Link - SAMUEL H.  SMITH
  195.             P. O. BOX 4808
  196.             PANORAMA CITY, CA 91412-4808
  197.             U.S.A.
  198.             The Tool Shop BBS (818) 891-6780 (USRobotics 2400)
  199.  
  200. ══════════════════════════════════════════════════════════════════════════════
  201. APPENDIX A - Revisions
  202. ──────────────────────────────────────────────────────────────────────────────
  203.   4.00  - Added ability to "autodetect" the external zmodem protocol and adjust
  204.           the parameters for the protocol appropriately.
  205.         - Added DCE/DTE rate support for Telix v3.22.
  206.         - Added support for more of the protocol switches.
  207.         - Cleaned up the configuration script.
  208.           - Added color selection with the arrow keys.
  209.           - Added "Pause after transfer" option.
  210.   3.30- MAJOR improvements and added features:
  211.         - Support for TXZM (Texas Zmodem;Good!), SZMODEM, GIFLINK and Hydracomm.
  212.         - Display BBS in status area (REGISTERED VERSION)
  213.         - Support for custom COM port configurations.
  214.         - Auto configuration for disk buffer and transfer buffer sizes and
  215.           flow control.
  216.   3.22- Added 'E' option to the file manager for manual entry of filenames.
  217.   3.21- Fixed missing space between -m and dl directory bug. Reported by Philip
  218.         Choy. Removed some of the default settings for HS/Link. Now minimun set
  219.         supported for correct operation.
  220.   3.2 - Added change directory logic for DSZ/GSZ so downloads are directed to
  221.         the download directory.
  222.   3.1 - Shorten the delay at start-up and removed the handshaking setting from
  223.         the GSZ/DSZ configuration. Now, only the minimum switches are set for
  224.         operation.
  225.   3.0 - Added a file manager for marking files for upload! This facility is
  226.         supported for HS/Link upload requests. When AUTODL receives an upload
  227.         request from HS/Link, AUTODL will present the file manager for marking
  228.         the files to upload. Telix finally has a facility for
  229.         "point-and-click" file marking. Registered version comes with a file
  230.         manager for GSZ/DSZ and MPt.
  231.   2.3 - Fixed a few minor bugs.
  232.   2.2 - Prompts for files upon a Zmodem upload request.
  233.   2.0 - Added HS/Link and revamped the configuration setup and AUTODL code.
  234.   1.1 - Added DSZ/GSZ support.
  235.   1.0 - Initial release.
  236.